home *** CD-ROM | disk | FTP | other *** search
/ CD ROM Paradise Collection 4 / CD ROM Paradise Collection 4 1995 Nov.iso / os2 / adaptor.zip / ADAPT.ZIP / adaptor / install.os2 < prev    next >
Text File  |  1994-01-04  |  6KB  |  112 lines

  1.    This file describes the installation instructions for port of ADAPTOR,
  2. software tool for Automatic Translation of Data Parallel Programs to the
  3. OS2 platform.
  4.  
  5.    Please refer to readme.os2 for the description of the software and
  6. for the list of requirements for sensible use of this software.
  7.  
  8.    Installation of this software is fairly painles. In adaptor\bin
  9. directory you get 3 tools used for translation of Fortran programs
  10. to Fortran programs that are parallel with the use of communication
  11. libraries based on message passing paradigm:
  12.  
  13.  - fadapt.exe is the actual Fortran to Fortran translator
  14.  - fstrip.exe is the tool to transform Fortran file generated by
  15.               fadapt.exe to the usual form (it limits the length of the
  16.               individual lines to be less or equal then 72 - or any
  17.               other number between 50 and 150, but 72 is Fortran
  18.               standard).
  19.  - fsplit.exe Tool to split Fortran source file into files containing
  20.               one routine each - functions, subroutines, block data
  21.               and main program (that means each function is in separate
  22.               file etc.). It is not directly used by the default setup
  23.               of fadapt, it is written in FORTRAN (sic) and I am
  24.               not even including source code, because to read command
  25.               line options it uses some routines from the CERN library.
  26.               I wrote it because I got frustrated not to have such a tool
  27.               in OS2 (every compiler vendor of commercial Fortran
  28.               compilers on UNIX platforms is shipping it with their
  29.               compiler, but I am using f2c so I was forced to write
  30.               it). But hey, it works.
  31. Copy these 3 files to your usual tools directory or to the place in
  32. your path.
  33. fadapt.exe after invocation with the optional parameters (read original
  34. documantation) generates around 10 files describing the process of
  35. translating your code to parallel code and also generates makefile.
  36. In order to be able to use makefile directly without ever looking at
  37. it, you are asked to define two environmental variables:
  38.  PVM_ROOT - it is the base directory of the directory structure for
  39.             the PVM that you are supposed to use with this software
  40.             (see readme.os2). For instance:  set PVM_ROOT=d:/pvm3
  41.  DALIB    - this a place, where make (I am using dmake !) is supposed
  42.             to find two libraries (dalib.a and unilib.a) + four
  43.             object files (mhost.o, mnode.o, mnode1.o, mcube.o).
  44.             They are shipped in directory adaptor\lib so you can
  45.             set DALIB to point to this directory (or you can move them
  46.             to \emx\lib and let DALIB to point there).
  47.             Example:  set DALIB=d:/adaptor/lib
  48.  
  49.  
  50.  Now you can go to the examples directory, go one level deeper into
  51. simple and say:
  52.          fadapt -H simple.f
  53. If what happens is that you get various messages about different
  54. stages of translation and it all ends up with the message that host.f
  55. and node.f where successfully generated it seems to work. Now have
  56. a look (al least this time) at the content of the makefile and
  57. after that try to say: dmake in the same directory. If everything
  58. goes OK, you are left with host.exe in that directory and node.exe
  59. has been moved after creation to the directory where PVM expects
  60. "worker processes" (refer to PVM documentation) which is typically
  61. drive:/pvm3/bin/os2. Moving node.exe (so that it can be started by
  62. PVM deamon) was the reason for defining PVM_ROOT. If you don't
  63. define those two environmental variables, some reasonable defaults
  64. are chosen. If you have PVM deamon running, try to run host.exe.
  65. If everything works you are invited to read the original documentation
  66. for getting real understanding how ADAPTOR works.
  67. If nothing works you are invited to read the original documentation
  68. for getting real understanding how ADAPTOR works plus to do some
  69. thinking about what went wrong.
  70.  
  71.   You can recompile fadapt, fstrip plus libraries using makeadap.cmd
  72. located in adaptor directory. If you need to modify the way makefile
  73. is produced (because of the peculiarity of your setup) you have to
  74. read (and at least partly understand) the file makef.c in adaptor\src
  75. directory.
  76.  
  77.  
  78.   Technical remarks:
  79.  
  80.   The port itself consisted in changing the names of the routines
  81. to conform to 8.3 conventions and to change file makef.c in
  82. adaptor\src directory. That file generates makefile and is the
  83. most likely candidate for the one beeing changed if you want to
  84. get different looking make file.
  85.  
  86.   As you might have seen, I assume that you have popular file
  87. manipulation utilities from GNU collection: mv and rm.
  88.  
  89.   Fadapt can be compiled also with X-Windows support. I have avoided
  90. to make it even more difficult to use this software, so I am avoiding
  91. this option completely.
  92.  
  93.   One small warning: There is one small inconvenience present
  94. in the current port. If you have DATA statements in your routines,
  95. fadapt currently appends some additional definitions of its own to
  96. the end of the declarative part of the routine. It means some INTEGER
  97. and teh like definitions are appended after DATA statements. This
  98. violates Fortran standard (though most commercial compilers don't
  99. complain) and f2c complains about that. In this case you have to
  100. move those data statement by hand. I have communicated the problem
  101. to the authors and have some hope that it might be fixed in the next
  102. release of ADAPTOR.
  103.    Because of the character of the software, you are probably going
  104. to have to work with generated code at least a little bit anyway.
  105. But the quality of ADAPTOR as a tool is fairly high and it sure
  106. can save a lot of time to people like me that would have to paralellize
  107. the code by hand.
  108.  
  109.                                             Jan Ftacnik
  110.                                      ftacnikj@fnal05.fnal.gov
  111.  
  112.